home *** CD-ROM | disk | FTP | other *** search
/ Amiga Tools 5 / Amiga Tools 5.iso / devs / nullmodem.doc < prev    next >
Encoding:
Text File  |  1996-07-16  |  6.9 KB  |  178 lines
  1.  
  2.                           nullmodem.device v2.3
  3.  
  4.                           (c) 1993 Iain Hibbert
  5.  
  6.            nullmodem.device is a software device, that imitates
  7.            two modems and a phone line, on one machine. I wrote
  8.            it whilst looking at the WPL scripting language,  so
  9.            that I could play around without having to spend any
  10.            money on expensive  phone calls,  but it can be used
  11.            for testing various other programs.
  12.  
  13. 1. Installation
  14. ---------------
  15.  
  16.      This archive should contain two files:
  17.  
  18.         nullmodem.device
  19.         NullModem.doc
  20.  
  21.      Copy nullmodem.device to devs:nullmodem.device, and Read NullModem.doc
  22.  
  23. 2. Usage
  24. --------
  25.  
  26.      There are 10 units available, connected in pairs (you will  not  likely
  27.  need more than one pair, but it was as easy to provide 5)
  28.  
  29.                     Unit 0 <=> Unit 1
  30.                     Unit 2 <=> Unit 3
  31.                     Unit 4 <=> Unit 5
  32.                     Unit 6 <=> Unit 7
  33.                     Unit 8 <=> Unit 9
  34.  
  35.      Set up your Terminal/Mailer/BBS's to use one side each of  the  device,
  36.  you should be able to  select  a  replacement  for  the  serial.device  and
  37.  alternative unit numbers easily enough in the software or config files.  In
  38.  use, it emulates a simple hayes modem, with a limited AT command set:
  39.  
  40.     D           Dial
  41.  
  42.         this command causes the other side to RING for the number of
  43.         seconds specified in S1 (Dial Timeout) and returns NO CARRIER
  44.         if there was no answer. Anything after the D is discarded
  45.  
  46.     A           Answer
  47.  
  48.         attempts to answer the phone, returning the CONNECT message or
  49.         NO CARRIER if nobody was ringing us. Anything after the A is
  50.         discarded
  51.  
  52.     S<r>=<v>    set S register
  53.  
  54.         <r> is the register number, up to 077 (octal)
  55.         <v> is the value to set it to, values 0-0377 (octal)
  56.  
  57.         NOTE: both numbers need to be given in Octal
  58.  
  59.         The S registers you can play with are:
  60.  
  61.         #           Description                             Default
  62.  
  63.         0       AutoAnswer after # of rings                   000
  64.         1       Debugging Level (see section 4 below)         000
  65.         2       Dial Timeout                                  020
  66.         3       Answer Delay                                  002
  67.         4       which Speed to report (section 3 below)       012
  68.         5       Backspace character value                     010
  69.         7       which Protocol to report (section 3 below)    011
  70.        12       Toggle local echo on/off                      001
  71.  
  72.     L       List modem version information, and S Registers
  73.  
  74.     Z       sets the S-Registers to their default values
  75.  
  76.     Examples:
  77.  
  78.         ATZS1=1S4=5S7=7D123456  ; enable debugging, set connect message to
  79.                                 ; CONNECT 2400/REL-LAPM-COMP (v42bis), and
  80.                                 ; dial the other unit
  81.  
  82.         ATA                     ; attempt to answer
  83.  
  84. 3. Connect Speeds
  85. -----------------
  86.  
  87.      The Nullmodem device doesn't have connect speeds as such, because it is
  88.  not connected to any hardware.. but the CONNECT  message  is  configurable,
  89.  via a couple of S registers.
  90.  
  91.            Value          Speed (S4)          Protocol (S7)
  92.  
  93.             00              none                none
  94.             01              103                 /NONE
  95.             02              V21                 /SYNC
  96.             03              300                 /REL
  97.             04              1200                /REL-MNP
  98.             05              2400                /REL-MNP-COMP
  99.             06              4800                /REL-LAPM
  100.             07              7200                /REL-LAPM-COMP
  101.             10              9600                /V32
  102.             11              12000               /ARQ
  103.             12              14400               /ARQ/HST
  104.             13              16800               /ARQ/HST/HST/V42BIS
  105.             14              19200               /ARQ/HST/HST/MNP5
  106.             15                                  /ARQ/V32
  107.             16                                  /ARQ/V32/LAPM/V42BIS
  108.             17                                  /ARQ/V32/LAPM/MNP
  109.             20                                  /ARQ/V32/LAPM/MNP5
  110.             21                                  /ARQ/LAPM/V42BIS
  111.             22                                  /V42BIS
  112.  
  113.     The connect messages may be different for each side of the device
  114.  
  115. 4. Debug Levels
  116. ---------------
  117.  
  118.      Debugging info is sent to the internal serial port at 9600 baud, or you
  119.  can use Sushi to print it in a console window, debugging  levels  are  0-2,
  120.  from 0 = No debugging info to 2 = loads of useless junk. 1 is probably  the
  121.  most useful. If you have a modem on the internal serial port that you  want
  122.  to use while testing, do not enable debugging unless you run Sushi..
  123.  
  124. 5. Technical Details
  125. --------------------
  126.  
  127.      The following device commands are not fully implemented:
  128.  
  129.         CMD_RESET       ;   there is nothing to reset, I don't think
  130.  
  131.         CMD_START       ;   these translate to XON/XOFF flow control,
  132.         CMD_STOP        ;   so you can't use that either.
  133.  
  134.         SDCMD_BREAK     ;   if anybody needs this, let me know what you
  135.                         ;   need it to do..
  136.  
  137.         SDCMD_SETPARAMS ;   there are no parameters to set
  138.  
  139.         SDCMD_QUERY     ;   not fully implemented, it returns the number of
  140.                         ;   characters in the buffer, and Carrier Detect,
  141.                         ;   but nothing else
  142.  
  143.  
  144.      I have partly implemented the ASDG extension command (io_Command = 16),
  145.  
  146.         ASDG_SET_CONTROL_LINES  ;   provides user control for RTS and DTR
  147.                                 ;   currently you can only lower DTR which
  148.                                 ;   causes the modem to hang up.
  149.  
  150.      Note that the modem does not handle +++ATH type hangups, you  must  use
  151.  either the Commodore suggested method of closing the serial  device  for  a
  152.  moment, or the above ASDG extension.
  153.  
  154. 6. Copyright
  155. ------------
  156.  
  157.      nullmodem.device is (C) 1993 Iain Hibbert and it's freely distributable
  158.  as long as all of its files are included in  their  original  form  without
  159.  additions, deletions, or modifications of any kind, and only a nominal  fee
  160.  is charged for its distribution.
  161.  
  162.      This software is provided "AS IS" without warranty of any kind,  either
  163.  expressed or implied. Reading Legal mush can turn your brain to  guacamole.
  164.  By using nullmodem.device you accept either the whole risk or  the  quality
  165.  and performance of the program.
  166.  
  167. 7. The Author
  168. -------------
  169.  
  170.       Iain Hibbert           UUCP:      plunky@closet.wizdom.royle.org
  171.                              FidoNet:   2:255/171.33
  172.                              AmigaNet:  39:136/1.33
  173.  
  174.      You should probably be able to reach me at one of the above  addresses,
  175.  if you are using Comms software regularly. Please contact me  if  you  have
  176.  any  problems  or  suggestions.  I  do  not  guarantee  to  implement   any
  177.  suggestions or fix any bugs, but it can't hurt to try.
  178.